home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / installed_progs / text / faqs / x-faq.intel-unix-x-faq < prev    next >
Encoding:
Internet Message Format  |  1994-05-01  |  30.3 KB

  1. Subject: X on Intel-based Unix Frequently Asked Questions [FAQ]
  2. Newsgroups: comp.windows.x.i386unix,comp.unix.pc-clone.32bit,comp.unix.bsd,comp.windows.x,comp.answers,news.answers
  3. From: steve@ecf.toronto.edu (Steve Kotsopoulos)
  4. Date: Fri, 29 Apr 1994 21:29:09 GMT
  5.  
  6. Archive-name: x-faq/Intel-Unix-X-faq
  7. Last-modified: 29 April 1994
  8.  
  9. This article includes answers to:
  10.  
  11. I) What options do I have for X software on my Intel-based Unix system?
  12.     1. Free options
  13.     2. Commercial options
  14. II) What is XFree86 and where do I get it?
  15.     3. What is XFree86?
  16.     4. What OSs are supported?
  17.     5. What video hardware is supported?
  18.     6. Who else supports accelerated boards?
  19.     7. [deleted]
  20.     8. What other hardware or software requirements are there?
  21.     9. Where can I get source for XFree86?
  22.     10. Where can I get binaries for XFree86?
  23. IV) What general things should I know about running XFree86?
  24.     11. Installation directories
  25.     12. Configuration files
  26.     13. Determining VGA dot clocks and monitor modes
  27.     14. Rebuilding/reconfiguring the server from the link kit
  28. V) What OS-specific things should I know about running XFree86?
  29.     15. SVR4
  30.     16. SVR3
  31.     17. 386BSD
  32.     18. Linux
  33.     19. Mach
  34. VI) What things should I know for building XFree86 from source?
  35. VII) Is there anything special about building clients with XFree86?
  36.     20. BSD compatibility library
  37.     21. ANSICCOPTIONS
  38. VIII) Where to get more information
  39.  
  40. The latest version of this article is available by anonymous
  41. ftp from ftp.x.org:/contrib/Intel-Unix-X-faq
  42.  
  43. This article does NOT include answers to general X questions, since they
  44. are already covered by the X FAQ that is regularly posted by David B. Lewis
  45. <faq%craft@uunet.uu.net>.
  46.  
  47. For information on X packages for DOS systems, consult the (PC)NFS FAQ
  48. available from seagull.rtd.com:/pub/tcpip/pcnfs.FAQ.v1.2.Z
  49.  
  50. If you have anything to add or change on this FAQ just let me know.
  51. (especially if you had a problem that someone else was able to help you with)
  52. Send changes to steve@ecf.toronto.edu, please put 'FAQ' somewhere
  53. in the subject line so that my mail filter will put it in the correct folder.
  54.  
  55. Please do not ask me questions that are not answered in this FAQ.  I don't
  56. have time to respond to these individually.  Instead, post your question
  57. to the net, and send me the question and answer together when you get it.
  58.  
  59. Frequently Asked Questions About X on Intel-based Unix (with answers)
  60. =====================================================================
  61.  
  62. I) What options do I have for X software on my Intel-based Unix system?
  63.  
  64. 1. Free options
  65.  
  66.     The BEST option is XFree86, which is an enhanced version of X386 1.2.
  67.     Any other version of X386 will be more difficult to compile.
  68.     Information on how to obtain it is listed below.
  69.  
  70.     X386 is the port of the X11 server to System V/386 that was done by
  71.     Thomas Roell (roell@sgcs.com).  It supports a wide variety of SVGA boards.
  72.     There are 2 major free versions: X386 1.1 is based on X11R4,
  73.     X386 1.2 is included in MIT's X11R5 distribution (ie. you
  74.     don't need to patch it into the MIT source any more).
  75.     X386 1.3 is the current commercial offering from SGCS (see below).
  76.  
  77.     Several other options are available for people running NeXTSTEP on
  78.     i486 and Pentium hardware. Information on mouseX, Cub'X and Co-Xist
  79.     is available via anonymous ftp from cs.orst.edu in /pub/next/XNeXT.
  80.  
  81. 2. Commercial options
  82.  
  83.      1) Metro Link
  84.     2213 W. McNab Road
  85.     Pompano Beach, FL  33069
  86.     (305) 970-7353
  87.     Fax: (305) 970-7351
  88.     email: sales@metrolink.com
  89.  
  90.     Summary: OS:    QNX, SVR3, SVR4.[012], SCO, UnixWare, LynxOS, 
  91.             DESQview/X, Venix, ISC, Solaris, Pyramid, SunOS
  92.          HW:    EGA, VGA, SVGA, TIGA, TARGA, 8514/A, Mach, 
  93.             S3, WD, Fujistu, Matrox, Microfield Graphics, R33020
  94.          Other: Motif, OpenLook/XView, XIE Imaging Extension,
  95.             Xv Video Extension, Audio Drivers, Multi Media
  96.  
  97.      2) SGCS (Snitily Graphics Consulting Services)
  98.     894 Brookgrove Lane
  99.     Cupertino, CA  95014
  100.     (800) 645-5501, (408) 255-9665
  101.     Fax: (408) 255-9740
  102.     email: info@sgcs.com  or ...!mips!zok!info
  103.  
  104.     SGCS is out of the X-Server business. Thomas Roell has a new company
  105.     called X-Inside, Inc. that is beta-testing its products right now.
  106.  
  107.      3) Consensys Corporation
  108.     1301 Pat Booker Rd.
  109.     Universal City, TX 78148
  110.     Phone: 1-800-388-1896
  111.     FAX:   1-416-940-2903
  112.     email: info@consensys.com
  113.  
  114.     Summary: OS: Consensys V4.2, Consensys' version of
  115.              Unix System V Release 4.2
  116.          HW: X11R4 server support for VGA, SVGA
  117.          Other: MoOLIT, Motif, X11R5 Clients
  118.  
  119.      4) The Santa Cruz Operation, Inc.
  120.     p.o. box 1900
  121.     Santa Cruz, California 95061
  122.     (408) 425 7222, (800) SCO UNIX,
  123.     FAX: (408) 458 4227
  124.     email: info@sco.com
  125.  
  126.     Summary: OS: ODT 1.1, ODT 2.0, ODT 3.0
  127.          HW: X11R5 server support for SVGA, 8514/A, S3, TMS340x0,
  128.              GD5426, P9000, ET4000/W32, Mach32, WD90C33, 86C801,
  129.              86C805, 86C928, WD90C31, XGA2, QVision, misc. localbus
  130.              video systems (see Hardware Compatibility Handbook
  131.              for actual card vendors).
  132.          Other: Motif
  133.  
  134.      5) Answer Software & Consulting
  135.     p.o. box 14171
  136.     Columbus, Ohio 43214
  137.     614-263-XLAB
  138.     email: sales@x4coher.com
  139.  
  140.     Summary: OS: Coherent 4.0.1r72 or greater
  141.          HW: works with any VESA compliant video
  142.  
  143.  
  144.      6) OpenWindows (shipped as part of the Solaris for x86 OS)
  145.     SunSoft Inc.
  146.     2550 Garcia Ave.
  147.     Mountain View, CA  94043
  148.     Phone: 415-960-3200
  149.  
  150.     Summary: OS: Solaris for x86, SunSoft's version of SVR4
  151.          HW: Orchid ProDesigner II, Compaq QVision, Paradise
  152.              Accelerator Board, ET 4000 video card with VESA
  153.              configuration file, WD90C30 video card with VESA
  154.              configuration file, IBM XGA.
  155.          Other: X11R4 clients, XView, OLIT, DeskSet
  156.  
  157.      7) Mark Williams Company
  158.     60 Revere Drive
  159.     Northbrook, IL 60062
  160.     (800) 636-6700 (U.S.)
  161.     (708) 291-6700 (outside U.S.)
  162.  
  163.     Summary:  OS:   COHERENT 4.2
  164.           HW:   VGA cards (ATI, Genoa, Paradise, Trident, Tseng, and
  165.             Western Digital chip sets), and serial mouse
  166.           MISC: Port of X386 1.2
  167.  
  168.   NOTE: Other commercial vendors (including OS vendors describing
  169.     bundled software) are welcome to submit summary information
  170.     summary information such as the above.
  171.  
  172. II) What is XFree86 and where do I get it?
  173.  
  174. 3. What is XFree86?
  175.  
  176.    XFree86 is an enhanced version of X386 1.2, which was distributed with
  177.    X11R5.  This release consists of many bug fixes, speed improvements, and
  178.    other enhancements. The release is available as source patches against the
  179.    MIT X11R5 code, as well as binary distributions for many architectures.
  180.  
  181.    XFree86 2.1 is not a huge release compared to prior XFree86 releases. There
  182.    are a number of reasons for this, including the fact that two of the Core
  183.    Team members have moved and started new employment, significantly cutting
  184.    into their time for XFree86 work.  In addition, they are hard at work on
  185.    merging XFree86 with the upcoming X11R6.  Many new features have been put
  186.    on hold while this integration is done, so that a stable and viable X11R6
  187.    release can be developed.  XFree86 3.0 will be released on the X11R6
  188.    contributed software distribution, and it is their intention that many of
  189.    these features will be present in that release.
  190.  
  191.    The following items have been added since XFree86 2.0 was released in
  192.    October 1993:
  193.  
  194.     1) The X Consortium's fix-26 is included.
  195.     2) Support for pixel multiplexing has been added for Mach32 boards
  196.        with ATI68875, TLC34075 or Bt885 RAMDACs.  This allows dot clocks
  197.        up to 135MHz to be used with these boards.
  198.     3) Support for the TI ViewPoint 3020 RAMDAC used on the #9 GXe
  199.        Level 14 and 16 cards has been added, supporting dot clocks up to
  200.        135MHz and 200MHz respectively.
  201.     4) Support for pixel multiplexing (and thus dot clocks up to 135MHz)
  202.        has been added for the SPEA Mercury cards (S3 928 + Bt485).  This
  203.        has *not* been tested on other 928 + Bt485 cards.
  204.     5) Performance improvements for some of the accelerated servers.
  205.     6) Support has been added for all the display widths available with
  206.        the S3 chips.  In addition to the 1024 and 1280 widths supported
  207.        by XFree86 2.0, there is now support for 640, 800 and 2048 with
  208.        all 801, 805 and 928 chips.  1152 is supported with 801/5 chips
  209.        at revision C or later.  1152 and 1600 are supported with 928
  210.        chips at revision E or later.  Note that this change should make
  211.        XFree86 viable on 512k boards.
  212.     7) Support for 8-bit resolution RGB values (as opposed to the
  213.        standard VGA 6-bit resolution) for S3 cards with AT&T20C490/1,
  214.        Sierra SC15025 or Ti3020 RAMDACs, and for Mach32 cards with
  215.        ATI68875, TLC34075 or Bt885 RAMDACs.
  216.     8) Support for DRAM based S3 cards using slow memory has been
  217.        improved.
  218.     9) Accelerated support for the Cirrus chipsets has been enhanced and
  219.        extended to include the lower-end chipsets (5420, 5422, 5424).
  220.    10) The pvga1 driver can now access all the clocks on boards using the
  221.        WD90C30 and WD90C31 chips.
  222.    11) The 16 colour generic VGA server has been extended to include
  223.        banked memory support on selected chipsets.  This allows it to
  224.        make full use of the available video memory on these boards.  This
  225.        server now includes support for GrayScale and StaticGray visuals
  226.        which makes for better use on many laptops.
  227.    12) Support for the Sigma LaserView and Visa monochrome boards has
  228.        been added to the bdm2 driver in the Mono server.
  229.    13) Support for Solaris x86 2.1 has been added.
  230.    14) Support is included for shared libraries on FreeBSD-1.1 and
  231.        NetBSD-current (0.9 based) systems.
  232.    15) The SuperProbe program introduced with XFree86 1.3 has been updated
  233.        to detect more chipsets, to detect installed video memory,  and to 
  234.        be more reliable overall.
  235.    16) Several dozen bug fixes for problems detected and reported for
  236.        XFree86 2.0.
  237.  
  238.    Plus a number of other small things.  Refer to the CHANGELOG file in the
  239.    source distribution for full details.
  240.  
  241.    Here is a list of the other significant features that XFree86 adds over
  242.    stock X386 1.2 (X11R5):
  243.  
  244.     1) New servers to support S3, ATI and 8514 accelerated hardware, and 
  245.        support for Cirrus and Western Digital accelerated hardware in
  246.        the SVGA server.
  247.     2) The SpeedUp package from Glenn Lai is an integral part of the 
  248.        SVGA server, selectable at run-time via the Xconfig file.  Some 
  249.        SpeedUps require an ET4000 based SVGA, and others require a 
  250.        virtual screen width of 1024.  The SpeedUps suitable to the 
  251.        configuration are selected by default.  With a high-quality 
  252.        ET4000 board, this can yield up to 40% improvement of the Xstones 
  253.        benchmark over X386 1.2.
  254.     3) The fX386 packages from Jim Tsillas are included as the default
  255.        operating mode of the SVGA server if SpeedUp is not selected.  
  256.        This mode is now equivalent in performance to X386 1.1b (X11R4), 
  257.        and approximately 20% faster than X386 1.2.
  258.     4) A monochrome server that supports bank-switching of available SVGA
  259.        memory to allow virtual screens up to 1600x1200.
  260.     5) Support for the Hercules mono card in the monochrome server, and 
  261.        with it the ability to support a "two headed" server - one mono 
  262.        VGA, and one Hercules.
  263.     6) Support for Hyundai HGC1280, Sigma LaserView and Visa monochrome
  264.        graphics card in the monochrome server.
  265.     7) A 16-color VGA server is included, which supports generic VGA
  266.        hardware.
  267.     8) SVR3 shared libraries, tested under ISC SVR3 2.0.2, 2.2, 3.0.1 and
  268.        4.0; SCO 3.2.2, 3.2.4.
  269.     9) Support for Linux, 386BSD, NetBSD, FreeBSD, BSD/386, Mach, OSF/1,
  270.        SVR4.2, SCO, Solaris 2.1, Amoeba, and Minix-386. Including shared
  271.        libraries for Linux, FreeBSD and NetBSD.
  272.    10) Support for LOCALCONN.  This support is for both SVR3.2 and SVR4.
  273.        For SVR4.0.4 with the 'Advanced Compatibility Package' and on
  274.        SVR4.2, local connections from SCO XSight/ODT clients are supported.
  275.    11) Drivers for ATI, Trident, NCR, Compaq, Cirrus, and OAK SVGA chipsets.
  276.        Refer to chipset-specific README files for details about these
  277.        drivers.
  278.    12) Support for compressed bitmap fonts has been added (Thomas
  279.        Eberhardt's code from the contrib directory on ftp.x.org).
  280.    13) Type1 Font code from MIT contrib tape has been included, and is
  281.        compile-time selectable.  There are contributed Type1 fonts in the
  282.        contrib directory on ftp.x.org.
  283.    14) New configuration method which allows the server's drivers and font
  284.        renderers to be reconfigured from both source and binary
  285.        distributions.
  286.    15) Greatly improved documentation and configuration databases are
  287.        included.
  288.    16) A new tutorial on how to develop correct video card and monitor
  289.        timing data, written by Eric Raymond (derived from previous
  290.        documentation and a lot of experimentation).
  291.    17) Greatly improved support for international keyboards, including
  292.        implementation of the Compose key functionality found on many
  293.        vendor servers.
  294.    18) Many enhancements in error handling and parsing of the Xconfig
  295.        configuration file.  Error messages are much more informative and
  296.        intuitive, and more validation is done.  There are many new options
  297.        that can be enabled in the Xconfig file.
  298.  
  299.    Also included are a tutorial on monitor timing by Eric Raymond, and the
  300.    current X386 mode database and a sample xdm configuration by David Wexelblat.
  301.  
  302.    Known bugs in XFree86:
  303.  
  304.     1) There are some problems with some of the 'xset fp' operations (in
  305.        particular 'xset fp rehash').  These seem to be caused by memory
  306.        allocation/deallocation problems in the server's font code.  We
  307.        believe that we have worked around this problem, but have not yet
  308.        solved the root cause.
  309.     2) While not strictly a bug, there is currently a limitation on the
  310.        dot-clock frequencies allowed in the S3 and Mach32 servers.  For
  311.        S3 cards with the Bt485 RAMDAC (e.g. #9 GXe), the limit is 85Mhz.
  312.        For Mach32 boards, the limit is 80Mhz.  There is some special
  313.        programming required to use these RAMDACs at higher dot-clocks,
  314.        and we were not able to get it fully developed in time.  We intend
  315.        to release a patch with these updates in the near future.
  316.  
  317. 4. What OSs are supported?
  318.  
  319.     SVR4.0:
  320.     Esix: 4.0.3A, 4.0.4, 4.0.4.1
  321.     Microport: 2.2, 3.1, 4.1, 4.2
  322.     Dell: 2.1, 2.2
  323.     UHC: 2.0, 3.6
  324.     Consensys: 1.2
  325.     MST: 4.0.3 (Load 2.07 and Load 3.02)
  326.     ISC: 4.0.3
  327.     AT&T: 2.1, 4.0
  328.     NCR: MP-RAS
  329.     SunSoft: Solaris x86 2.1
  330.  
  331.     SVR4.2:
  332.     Consensys
  333.     Univel UnixWare
  334.  
  335.     SVR3:
  336.     Interactive: 2.0.2, 2.2, 3.0, 4.0
  337.     SCO: 3.2.2, 3.2.4
  338.     AT&T: 3.2.2
  339.  
  340.     Others:
  341.     386BSD 0.1, NetBSD 0.9, FreeBSD 1.1(beta)
  342.     BSD/386 1.0
  343.     Mach 386
  344.     OSF/1
  345.     Linux 0.99pl15h
  346.     Amoeba
  347.     Minix-386
  348.  
  349.     Note that Esix 3.2D is not supported yet, but anyone should feel
  350.     free to submit patches.  If you are interested in tackling this,
  351.     send mail to xfree86@physics.su.oz.au
  352.  
  353. 5. What video hardware is supported?
  354.  
  355.    At this time, XFree86 2.1 supports the following accelerated chipsets:
  356.  
  357.     8514/A (and true clones)
  358.     ATI Mach8, Mach32
  359.     Cirrus CLGD5420, CLGD5422, CLGD5424, CLGD5426, CLGD5428
  360.     S3 86C911, 86C924, 86C801, 86C805, 86C805i, 86C928
  361.     Western Digital WD90C31
  362.  
  363.     The Cirrus and Western Digital accelerators are supported in the SVGA
  364.     server; the other chipsets each have their own server.  A list of cards
  365.     on which the accelerated servers have been tested is included in the file
  366.     AccelCards.  They may well work on other cards, but we cannot guarantee it.
  367.   
  368.    In addition, the following SVGA chipsets are supported:
  369.     
  370.     Tseng ET3000, ET4000AX, ET4000/W32
  371.     Western Digital/Paradise PVGA1
  372.     Western Digital WD90C00, WD90C10, WD90C11, WD90C24, WD90C30, WD90C31
  373.     Genoa GVGA
  374.     Trident TVGA8800CS, TVGA8900B, TVGA8900C, TVGA8900CL, TVGA9000,
  375.         TVGA9000i, TVGA9100B, TVGA9200CX, TVGA9320, TVGA9400CX, TVGA9420
  376.     ATI 28800-4, 28800-5, 28800-a
  377.     NCR 77C22, 77C22E, 77C22E+
  378.     Cirrus Logic CLGD5420, CLGD5422, CLGD5424, CLGD5426, CLGD5428
  379.          CLGD6205, CLGD6215, CLGD6225, CLGD6235
  380.     Compaq AVGA
  381.     OAK OTI067, OTI077
  382.     
  383.     All of the above are supported in both 256 color and monochrome modes,
  384.     with the exception of the ATI and Cirrus chipsets, which are only
  385.     supported in 256 color mode.  Also, the new Vision864 and Vision964
  386.     chipsets from S3 are known not to work with XFree86-2.x.
  387.  
  388.     Refer to the chipset-specific README files (currently for Tseng, Western
  389.     Digital, ATI, and Trident) for more information about using those chipsets.
  390.  
  391.     The monochrome server also supports generic VGA cards, using 64k of video
  392.     memory in a single bank, the Hercules monochrome card, the Hyundai
  393.     HGC1280, Sigma LaserView and Visa monochrome cards.  On the Compaq AVGA,
  394.     only 64k of video memory is supported for the monochrome server, and the
  395.     GVGA has not been tested with more than 64k.
  396.  
  397.     The VGA16 server has not been as extensively tested and debugged as the
  398.     others, but it should work rather well (but slowly) on most hardware.
  399.     This server supports memory banking with the ET4000 and Trident chipsets
  400.     allowing virtual display sizes up to about 1600x1200 (with 1MB of video
  401.     memory).  For other chipsets the display size is limited to approximately
  402.     800x600.
  403.  
  404.       Note
  405.       ----
  406.     Some of the SVGA card manufacturers are using non-traditional mechanisms 
  407.     for selecting pixel-clock frequencies.  To avoid having to modify the 
  408.     server to accommodate these schemes XFree86 1.2 added support for using 
  409.     an external program to select the pixel clock.  This allows programs to 
  410.     be written as new mechanisms are discovered.  Refer to the README.clkprog 
  411.     file for information on how these programs work, if you need to write one.
  412.     If you do develop such a program, we would be interested in including it 
  413.     with future XFree86 releases.
  414.  
  415.     NOTE: The Diamond SpeedStar 24 (and possibly recent SpeedStar+) boards are
  416.           NOT supported, even though they use the ET4000. The same is true
  417.           for all of Diamond's S3 boards. The reason for this is that
  418.           Diamond has changed the mechanism used to select pixel clock 
  419.           frequencies, and will only release programming information under
  420.           non-disclosure.  We are not willing to do this (as it would mean
  421.           that source cannot be provided).  We have had discussions with
  422.           Diamond over this, and they do not intend to change this policy.
  423.           Hence we will do nothing to support Diamond products going forward
  424.           (i.e. don't send us a program to run to set their clocks).  XFree86
  425.           DOES NOT SUPPORT DIAMOND HARDWARE.  It is possible to make some
  426.           of it work, but we will not assist in doing this.
  427.     
  428.           Diamond's Cirrus-based boards should work with XFree86 because they
  429.           use the standard Cirrus clock synthesiser.  This includes the
  430.           SpeedStar Pro and possibly the SpeedStar 64.
  431.  
  432. 6. Who else supports accelerated boards?
  433.  
  434.     This support is available in commercial products several vendors.
  435.     See the "Commercial options" section for details.
  436.  
  437. 8. What other hardware or software requirements are there?
  438.  
  439.     Obviously, a supported video board and OS are required.  To run
  440.     X efficiently, 8-12MB of real memory should be considered a minimum.
  441.     The various binary releases take 10-40MB of disk space, depending
  442.     on the OS (e.g. whether or not it supports shared libraries).
  443.     To build from sources, at least 80MB of free disk space will
  444.     be required, although 120MB should be considered a comfortable 
  445.     lower bound. If you are VERY tight on space, look into tinyX.
  446.  
  447. 9. Where can I get source for XFree86?
  448.  
  449.     Source patches based on X11R5 PL25, from MIT, and as an upgrade from
  450.     XFree86 2.0 are available via anonymous FTP from:
  451.  
  452.         ftp.x.org (under /contrib/XFree86)
  453.         ftp.physics.su.oz.au (under /XFree86)
  454.         ftp.win.tue.nl (under /pub/XFree86)
  455.         ftp.prz.tu-berlin.de (under /pub/pc/src/XFree86)
  456.  
  457.     (For the rest of this FAQ, these 4 location will be called $FTP)
  458.  
  459.     Refer to the README file under the specified directory for information on
  460.     which files you need to get to build your distribution (which will depend
  461.     on whether this is a new installation or an upgrade from an earlier
  462.     version of XFree86).
  463.  
  464. 10. Where can I get binaries for XFree86?
  465.  
  466.     Binaries are available via anonymous FTP from:
  467.        ftp.physics.su.oz.au            - SVR4 binaries
  468.                 under /XFree86/SVR4
  469.        ftp.win.tue.nl                  - SVR4 binaries
  470.                 under /pub/XFree86/SVR4
  471.        ftp.tcp.com                     - SVR4 binaries
  472.                 under /pub/SVR4/XFree86
  473.        stasi.bradley.edu               - SVR4 binaries
  474.                 under /pub/XFree86/SVR4
  475.        stasi.bradley.edu               - Solaris x86 2.1 binaries
  476.                 under /pub/XFree86/solaris
  477.        stasi.bradley.edu               - SVR3 (SCO) binaries
  478.                 under /pub/XFree86/sco
  479.        ftp.physics.su.oz.au            - SVR3 (SCO) binaries
  480.                 under /XFree86/SCO
  481.        blancmange.ma.utexas.edu        - SVR3 (ISC) binaries
  482.                 under /pub/ISC
  483.        ftp.prz.tu-berlin.de            - SVR3 (ISC) binaries
  484.                 under /pub/pc/isc/XFree86
  485.        tsx-11.mit.edu                  - Linux binaries
  486.                 under /pub/linux/packages/X11
  487.        ftp.unipi.it                    - Linux binaries
  488.         under /pub/linux/XFree86_2.1
  489.        XFree86.cdrom.com               - FreeBSD binaries
  490.         under /pub/XFree86/FreeBSD/XFree86-2.1
  491.        gil.physik.rwth-aachen.de       - FreeBSD binaries
  492.         under /pub/XFree86
  493.        agate.berkeley.edu              - NetBSD 0.9 binaries
  494.         under /pub/NetBSD/ports
  495.        sun-lamp.cs.berkeley.edu        - NetBSD 0.9 binaries
  496.         under /pub/NetBSD/ports
  497.        ftp.cs.mcgill.ca                   - NetBSD 0.9 binaries
  498.             under /pub/NetBSD/XFree86
  499.  
  500.     Ensure that you are getting XFree86 2.1 - some of these sites may archive
  501.     older releases as well.  Each binary distribution will contain a README
  502.     file that describes what files you need to take from the archive, and
  503.     which compile-time option selections were made when building the
  504.     distribution.
  505.  
  506. IV) What general things should I know about running XFree86?
  507.  
  508. 11. Installation directories
  509.  
  510.     The top-level installation directory is specified by the ProjectRoot
  511.     (/usr/X386, by default) variable in config/site.def. Binaries, include
  512.     files, and libraries are installed in $ProjectRoot/{bin,include,lib}.
  513.  
  514.     This can be changed when rebuilding from sources, and can be modified
  515.     via symbolic links for those OSs that support them. This directory is
  516.     nonstandard, and was chosen this way to allow XFree86 to be installed
  517.     alongside a commercial/vendor-supplied X implementation.
  518.  
  519. 12. Configuration files
  520.  
  521.     The XFree86 server reads a configuration file ("Xconfig") on startup.
  522.     The search path, contents and syntax for this file are documented in
  523.     the server manpage, which should be consulted before asking questions.
  524.  
  525. 13. Determining VGA dot clocks and monitor modes
  526.  
  527.     David E Wexelblat (dwex@mtgzfs3.att.com) maintains a database of known
  528.     clock settings for VGA cards and monitor settings.
  529.     The database is installed in /usr/X386/lib/X11/etc/modeDB.txt, and
  530.     is in the source tree under mit/server/ddx/x386/etc. This database is
  531.     also available from him (for the latest copy), and is kept on
  532.     export.lcs.mit.edu in ~/contrib/X386.modeDB.Z, which is updated
  533.     occasionally.  Obtain a copy of this database.  It just might have the
  534.     settings you need.  If you create new settings, please send them to
  535.     David for inclusion in the database.
  536.  
  537.     If this doesn't help you, the VideoModes.doc (by Eric Raymond) file 
  538.     with XFree86 contains tutorials on how to come up with these timings.
  539.     Also look at the AccelCards file. It has a list of `known-to-work' cards
  540.     with additional info like clock chip, clocks, ramdac, etc.
  541.     It may be helpful to start with settings that almost work, and use
  542.     this description to get them right.  When you do, send the information
  543.     to David Wexelblat for inclusion in the database.
  544.  
  545.     NOTE: The old 'clock.exe' program is not supported any more, and
  546.       is completely unnecessary.  If you need to determine dot
  547.       clock values for a new board, remove the 'Clocks' line from
  548.       your Xconfig file (if present), and start the server.  The
  549.       server will probe for clocks itself and print them out.
  550.       You can use these values to put a 'Clocks' line into your
  551.       Xconfig file, which is not necessary, but will speed up
  552.       starting the server in the future.
  553.  
  554. 14. Rebuilding/reconfiguring the server from the link kit
  555.  
  556.     If you have installed the server Binary Link Kit, it is possible to
  557.     reconfigure the drivers and font renderers in the server.  This is
  558.     fully explained in the README file that is available with the link kit.
  559.  
  560. V) What OS-specific things should I know about running XFree86?
  561.  
  562.     First of all, the server must be installed suid-root (mode 4755).
  563.  
  564. 15. SVR4
  565.     Why won't my xterm run properly?
  566.  
  567.     If your kernel is not built with the consem module, you should define
  568.     CONSEM=no in you environment. Otherwise xterm won't run.
  569.     csh users should use 'setenv CONSEM no'
  570.  
  571.     The Esix console driver patch 403019 is known to cause keymapping
  572.     problems with XFree86.  It recommended that this patch not be
  573.     installed.  Alternatively they keymap can be fixed with xmodmap.
  574.  
  575. 16. SVR3
  576.  
  577.     Make sure you look at $FTP/README.ISC, if that's what you are running.
  578.  
  579. 17. 386BSD
  580.  
  581.     Make sure you look at $FTP/README.386BSD.
  582.  
  583.     Also, a separate 386BSD FAQ is maintained by Richard Murphey
  584.     <Rich@Rice.edu>.  The latest version should be available in the
  585.     file XFree86-1.2-386BSD-FAQ at the following ftp sites:
  586.  
  587.     agate.berkeley.edu:/pub/386BSD/0.1-ports/XFree86-1.2
  588.     wuarchive.wustl.edu:/mirrors4/386bsd/0.1-ports/XFree86-1.2
  589.     grasp.insa-lyon.fr:pub/386BSD/0.1-ports/XFree86-1.3
  590.  
  591. 18. Linux
  592.  
  593.     You must be running Linux 0.99pl13 or greater, and have the 4.4.1 gcc
  594.     jump libraries and ld.so-1.3 installed.
  595.  
  596.     Make sure all the servers XF86_*, xload and xterm are setuid root.
  597.  
  598.     If your kernel doesn't have TCP support compiled in, you'll have to
  599.     run the server as "X -pn". The default startup configuration assumes
  600.     that TCP is not available. If it is, change the two files
  601.     /usr/X386/bin/startx and /usr/X386/lib/X11/xdm/Xservers, removing the
  602.     -pn argument to X386.
  603.  
  604.     Make sure /dev/console is either a link to /dev/tty0 or has the major
  605.     number 4, minor number 0. Also note that if /dev/console is not
  606.     owned by the user running X, then xconsole and xterm will not permit
  607.     console output redirection. Xdm will properly change the owner, but
  608.     startx won't.
  609.  
  610.     For more detailed information, please read the files README and
  611.     X11-HOWTO present with the distribution on tsx-11.mit.edu.
  612.  
  613. 19. Mach
  614.  
  615.     Make sure you look at $FTP/README.Mach.
  616.  
  617. VI) What things should I know for building XFree86 from source?
  618.  
  619.     This section has been removed from the FAQ, since it is
  620.     fully explained in $FTP/README and the OS-specific READMEs.
  621.     Please look at those files for information on building XFree86.
  622.  
  623. VII) Is there anything special about building clients with XFree86?
  624.  
  625. 20. BSD compatibility library
  626.  
  627.     A lot of clients make use of BSD functions like bcopy(), etc.
  628.     The default configuration files are set up to link with libXbsd.a
  629.     which contains emulation for bcopy(), bzero(), bcmp(), ffs(), random(),
  630.     seed(). A better way of providing the 'b' functions is to include
  631.     <X11/Xfuncs.h> in source files that call them.  Xfuncs.h provides macro
  632.     definitions for these in terms of the SYSV 'mem' functions.  If you are
  633.     linking with a vendor supplied library which calls some of these
  634.     functions, then you should link with libXbsd.a
  635.  
  636. 21. ANSICCOPTIONS
  637.  
  638.     This is something that was added to allow a developer to get rid of the
  639.     ANSI-ness defined in the default CCOPTIONS without having to rewrite
  640.     the entire CCOPTIONS line.  For example, with stock MIT, you'd see
  641.     something like
  642.         CCOPTIONS="-ansi -O2 -fwritable-strings"
  643.     and to get rid of the ANSI-ness, the developer would have to put
  644.         CCOPTIONS="-O2 -fwritable-strings"
  645.     in his Imakefile.  With this change, you would see a default of
  646.         ANSICCOPTIONS="-ansi"
  647.         CCOPTIONS="-O2 -fwritable-strings"
  648.     and all the developer would have to put in the Imakefile is:
  649.         ANSICCOPTIONS=
  650.     to get rid of the ANSI-ness (many X clients will die a horrible death
  651.     with -ansi).  The effect is even more dramatic in practice, because
  652.     CCOPTIONS is actually quite complex.  The other issue is that one must
  653.     add 'ANSICCOPTIONS=$(ANSICCOPTIONS)' to a PassCDebugFlags definition.
  654.  
  655. VIII) Where to get more information
  656.  
  657.     Additional documentation is available in the XFree86(1), Xconfig(4/5),
  658.     XF86_SVGA(1), XF86_Mono(1), XF86_VGA16(1), XF86_Accel(1) and XF86keybd(1)
  659.     manual pages.  In addition, several README files and tutorial documents are
  660.     provided.  These are available in /usr/X386/lib/X11/etc in the binary
  661.     distributions, and in mit/server/ddx/x386 and ddx/x386/etc in the source
  662.     distribution.
  663.  
  664.     The files README.Config and VideoModes.doc should be consulted for 
  665.     information on how to set up the XFree86 servers.  All supplied documents
  666.     and manual pages should be read before contacting the XFree86 team for
  667.     assistance.
  668.  
  669.     Documentation on SVGA driver development can be found in the directory
  670.     /usr/X386/lib/Server/VGADriverDoc in the binary distribution, and in the
  671.     directory mit/server/ddx/x386/VGADriverDoc in the source distribution.
  672.  
  673.     There exists a Usenet news group comp.windows.x.i386unix that contains
  674.     mostly discussions about XFree86 and related topics. Many questions can
  675.     be answered there.
  676.  
  677.     If you are totally at a loss, you can contact the XFree86 Core Team at
  678.     xfree86@physics.su.oz.au.
  679.  
  680.     --------------------------------------------------
  681.  
  682. XFree86 Contact Information
  683.  
  684.     Ongoing development planning and support is coordinated by the XFree86
  685.     Core Team.  At this time the Core Team consists of (in alphabetical order):
  686.  
  687.        David Dawes <dawes@physics.su.oz.au>
  688.        Dirk Hohndel <hohndel@aib.com>
  689.        Rich Murphey <Rich@Rice.edu>
  690.        Jon Tombs <jon@gtex02.us.es>
  691.        David Wexelblat <dwex@goblin.org>, <dwex@aib.com>
  692.  
  693.     E-mail sent to <xfree86@physics.su.oz.au> will reach all of the Core Team.
  694.  
  695.     --------------------------------------------------
  696.  
  697. Thanks to all the people who already sent me corrections or additions,
  698. especially David Wexelblat (one of the major contributors of updates).
  699. -- 
  700. Steve Kotsopoulos  P.Eng.                         steve@ecf.toronto.edu
  701. Systems Analyst,  Engineering Computing Facility, University of Toronto
  702.  
  703.